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Low-cost 1, 2, 4 meg 
cards available soon 


A company called 
Optrol will soon deliver 
Port users from the 128K 
memory card limit. 

The company is work- 
ing on new | megabyte, 2 
megabyte, and 4 megabyte 
Flash Memory Cards for 
the Portfolio, which will 
be priced competitively 
with the 128K RAM card. 

Of course, cards with 
this kind of capacity have 
been available outside the 
United States, but not for 
these prices. The list price 
will be $179 for | meg, 
$254 for 2 megs, and $399 
for 4 megs. If you order 
them straight from Optrol 
before October 15, 1992, 
they will come at a special 
introductory price of $130, 
$180, and $280, respec- 
tively. After October 15, 
if you order the cards 
through Re:Port, you can 
still save money off the list 
price. 

Optrol expects to begin 
Continued on Page 8 


How to order one 


Optrol’s Flash Memory Cards are not yet ready 
to ship. You may contact Re:Port to express your 
interest in the product, and we will send you a 
mailing when the product is shipping, in which we 
will discuss prices and any last-minute details 
about the cards. 

To contact Re:Port, write to: 

Re:Port 

ATTN: Memory Cards 

806-34 Benton Drive 

lowa City, [A 52246-5207 

Or, call 1-319-354-6893 and leave a message 
saying that you would like to be sent information 
about the Flash cards as soon as they are available. 

As usual, Re:Port readers will receive dis- 
counts on list prices on the cards, but we have not 
yet determined a price schedule. 

If you know that you will want one of these 
cards, you can get an order in now directly with 
Optrol. Call 1-919-779-3377 for more informa- 
tion. 

If you order before October 15, 1992, Optrol 
will give you these special prices: 

| meg: $130 

2 megs: $180 

4 megs: $280 

Optrol expects delivery to begin at the end of 
September 1992. 
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¢ BJ Gleason takes 
a break; we have 
PowerBASIC tips 
instead. 
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e Test your reflexes 
with the challenging 
game SNAKE. Also, 
an update of last 
issue’s TODO.HOO. 
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e This issues’s fea- 
ture program, 
DELETE.HOO 
could save you from 
disaster while using 
the Editor. 

Page 6 


e Review ofthe DOS 
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Re:Port 


From the Editor 


Re:Port contests: Enter early, 


Here it is, the beginning of the 
second year of Re:Port newsletter! 

Fortunately, the response to the 
newsletter has been wonderful, and 
has been growing by the month. I’d 
like to thank everyone that has ex- 
pressed their happiness with the 
newsletter by resubscribing. 

If you received a ‘‘Re:Subscribe 
to Re:Port’’ flier but misplaced it, 
youcan use the form at the bottom of 
this page. 

Remember, you get a $5 gift cer- 
tificate toward your next purchase of 
anything through Re:Port when you 
resubscribe. 

Product orders have been going 
extremely well, too, which is one of 
the many ways that the newsletter 
can pay for itself. 

Typically, you will save at least 
$5 on a product that you buy through 
Re:Port rather than buying in the 
store. 

Another way to make Re:Port 
pay for itself is to get involved in our 
bimonthly contests. 

They are easy to enter, and they 
help us determine the direction that 
the newsletter should take. 


Unfortunately, these do seem to 
be the worst-received part of the 
newsletter. 

Usually, we receive only three or 
four entries out of the hundreds of 
Re:Port subscribers. That helps the 
entrants with better odds, to be sure, 
but it doesn’t help us take an accurate 
survey. 

So in this issue, we are increasing 
the ways that you can enter the con- 
test, but we do ask that you provide 
us with all the information that we 
ask for so we can make Re:Port 
serve you better. 

If you haven’t done so already, | 
would ask you to read Page | thor- 
oughly, because that’s where you’ll 
find exciting information about 
inexpensive, fast, and large storage 
for the Port. 

| think that these Flash cards, 
which come in | meg, 2 meg, and 4 
meg sizes, will be a big hit with Port 
users who are always complaining 
about the limitations on storage 
space. 

Although the larger cards may 
cut into Atari’s RAM card market, 
they also should attract more people 


enter often 


to the Portfolio. A 128K limited on 
RAM card sizes would definitely 
have been detrimental to the Port 
now that new palmtops and 
‘*subnotebook’’ computers are en- 
tering the market on an almost 
monthly basis. 

In this issue, you’ll also find tips 
on programming in PowerBASIC, a 
very addictive, graphical game, and 
a life-saving new editor hook file, 
which combines two readers’ ideas. 

You can also turn your dream 
utilities into reality, simply by sug- 
gesting them to Re:Port: 

Write to us at: 

Re:Port Programming 

806-34 Benton Drive 

lowa City, IA 52246-5207. 

For larger programming jobs, we 
also do custom programming. 

The rate depends on the length of 
the project and whether your busi- 
ness will purchase additional Portfo- 
lio units along with the program. 

This service is ideal for businesses 
that need systems for data entry, 
inventory, or any kind of field work. 

For more information, call 
Re:Port at 1-319-354-6893. 
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money order. 


Yes! Please continue my subscription to Re:Port for $50 US. I understand that I will 
continue to receive Re:Port uninterrupted, with its disks of software, free user support, and 
unbelievable prices on Portfolio products available to subscribers only. | also will receive a $5 gift 
certificate, which I may use toward any purchase through Re:/or1, including my next subscription, 
Portfolio products, back issues, or the new Re:Classifieds. I include $50 in US funds, check or 


Thank you! Please return this form with payment of $50 to: 


Re:Port newsletter, 806-34 Benton Drive, lowa City, [A 52246-5207 
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Please print your name as it appears on your Re:Port mailing labels: 
I 
i 
L 


ISH7 


Re:Port 


Page 3 


Industry News 


Carrying Case review; more sound 


Atari’s Portfolio Carrying Case ($34.16 to Re:Port 
subscribers) has been a top seller since we mentioned 
that they were available in the last issue. 

Re:Porthas finally been able to take a look at the case, 
and here’s what we found: 

The case is a soft, black vinyl, padded on the inside. 
It has the Atari logo on the front, and has room in the 
main pouch for just the Portfolio. Once the Port is 
slipped in, you can shut the main pouch with a flap and 
attach it with velcro. 

There is also a secondary pouch on the front of the 
case. 

The box that the carrying case comes in shows that 
you can fit a serial or parallel interface, along with 
several RAM cards, into this pouch, but realistically, 
that seems like a bit of a squeeze, although it could be 
done if you don’t mind jamming things a bit. 

The case is lacking in that is does not have a strap. It 
does have a belt hook, which means the case was most 
likely designed for people who use the Port in the field 
and need easy access to it. 

For those of you who don’t want to wear your Port 
like a six-shooter, you could find a strap and slide it 
through the belt loop. [t would be nice, though, if Atari 
would provide a strap. 

The carrying case is also well-suited for keeping your 
Portfolio safe while you transport it in a briefcase or any 
other place where it might be bumped around. 

Its padding is more than sufficient for some rough 
handling. 

However, because of the case’s lack of space, it is not 
asolution if you find yourself wanting to carrying a Port, 
a modem, a serial and parallel interface, many RAM 
cards, an AC adapter, and a change of batteries, which is 
a likely package for the serious Portfolio traveller. 

ANOTHER SOUND ADVANCE 

A Portfolio user in Germany has discovered a way to 
modify the Portfolio’s parallel interface to include a 
Digital-to-Analog convertor chip that can play digitized 
sound over the Portfolio. 

This is similar to the technology used in Disney’s 
Sound Source for desktop computers. And you can 
apparently still use your printer. 


All you have to do is hook up the modified parallel 
port to an external speaker, and your Portfolio is ready to 
become a true digital sound machine. 

The device is in the prototype stage right now, and the 
user has no full plans for developing and selling the 
product. 

If you have a use for this device and would like to find 
a way to get one, write to Re:Port at 806-34 Benton 
Drive, lowa City, [A 52246-5207. 

NEWS, SOFTWARE FOR BRITISH USERS 

The Portfolio Connection offers a large selection of 
public domain and shareware Portfolio-specific soft- 
ware on floppy disks for our readers in England. 

The Portfolio Connection also distributes a free Port- 
folio newsletter with information on its software along 
with some tips for using the Port (also known as the — 
Pocket PC over there). 

For more information about the Portfolio Connec- 
tion, write them at: 

Portfolio Connection 

Bucklands College 

Wallingford Road 

Cholsey Oxon 

OX10, 9H8 ENGLAND 

A BIGGER FLASHDRIVE 

The BSE company, markers of the Flashdrive, are 
now announcing that their product can handle disks up 
to 130 megabytes. which would greatly increase the 
portable storage capacity of the Portfolio. 

BSE also now has a representative on CompuServe 
APORTFOLIO forum who can answer questions and 
help you with Flashdrive usage. 

For more information on the BSE Flashdrive, contact 
BSE at: 

2160 North 4th St. Suite 210 

Flagstaff, AZ 86004 

1-602-527-8843 


If your company has Industry News, submit it to: 
Re:Port, Industry News 

806-34 Benton Drive 

Iowa City, IA 52246-5207 
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PowerBASIC 


How to make file selection menus with Power 


PowerBASIC ($71.96 from 
Re:Port for subscribers) is a program- 
ming language that is heavily based on 
the desktop computer version. It is 
made to be as completely compatible 
as possible with the desktop version of 
the program, and therefore it does not 
contain easy access to Portfolio-only 
features such as menus and sound. 

However, access to such features is 
relatively simple if you have a copy of 
the highly recommended Atari Portfo- 
lio Technical Reference Manual. 

Also, you may want to pick up a 
copy of BJ Gleason’s PowerBASIC 
Libraries, available onthe CompuServe 
APORTFOLIO forum (PBLIB.ZIP). 
It provides code that you can append 
into your own PowerBASIC programs. 

One interesting way to make your 
applications written inany language look 
more Port-ready is to add menu boxes 
filled with filenames that the user can 
select. However, this is never easy inany 
language, and even less so in 
PowerBASIC. Included on Re:Port 
Disk#7isanexample program, FF.BAS, 
that shows how it can be done. 

Disk #7 also includes 
PBRUN.RUN, a file that is necessary 
for running compiled PowerBASIC 
files. Makesure thatthe PBRUN.RUN 
is on your Portfolio whenever you run 
a PowerBASIC program. 

FF.BAS is a fileselector program 
only. If you wish to add this code to 
your own program, please feel free. It 
is up to you what to do with a filename 
once it is selected! 

To begin, we make room for the 
filenames, turn on the cursor, and also 
bring in three functions from BJ 
Gleason’s PowerBASIC library. 


Then, we’ll 
call the initializa- 
tion subroutine 
(something that 
you should do at 
the start of every 
Portfolio pro- 
gram, though not 
if you want the 
same program to 
run on a desktop PC), turn on the 
cursor, and tell the user that we’re 
loading the files: 
call init 
cls 
call cursoron 
?” Loading filenames” 

Next, we'll need to find out where 
DOS’s Disk Transfer Area is. This 
area will store the filename informa- 
tion that we’ re looking for: 
reg 1,47*256 
call interrupt 33 
dtaseg = reg(9) 
dtaptr = reg(2) 

Now, we'll tell DOS to seek the 
first file and add it to our menu string: 
filename$ = command$+chr$(0) 
if command$ = “” then filename$ = 
‘“k exe” + chr$(0) 
reg 8,strseg(filename$) 
reg 4,strptr(filename$) 
reg |,78*256 
reg 3,32 
call interrupt 33 
storeax = reg(1) 
menu$ = “Files” +chr$(0) 
namecount = 0 
gosub 1000 

Keep searching for more: 
while storeax <> 18 

reg 1,79*256 

call interrupt 33 

storeax = reg(!) 

if storeax <> 18 then gosub 1000 


Sass 
@.- 


Gleason on PBASIC 


Columnist BJ Gleason is busy with exams, 
summer vacation, and a new programming 
project this month, so he wasn't able to 


write his PBASIC coiv’nf this dime. He'll be 

ON DISK back next issue. However, PBASIC can be 
found on Re:Port Disk #7 in the \PBASIC 
subdirectory. The files in this column can 
be found in the \POWER subdirectory. 


wend 
cls 
Finally for the main routine, dis- 
play the menu and print the results. 
An error will be returned if the user 
hits escape. 
menu$ = menu$ + chr$(0) 
ms1% = fnsigned%(strseg(menu$)) 
ms2% = fnsigned%(strptr(menu$)) 
returned% = 
fnmenu%(0,0,0,0, | ,ms 1 %,ms2%) 
cls 
hello = returned% mod 256 
? pickname$(hello) 
? len(menu$) 
end 
This subroutine adds found 

filenames into the menu string. 
1000 foundname$ = “” 
zero =0 
DEF SEG = dtaseg 
fora=Oto 12 

if (peek(dtaptr+30+a) 
zero = zero + | 

if zero = 0 then foundname$ = 
foundname$ + 
chr$(peek(dtaptr+30+a)) 

next a 
def seg 
menu$ = menu§$ + foundname$ + 
chr$(0) 
pickname$(namecount) = 
foundname$ 
namecount = namecount + | 
return 


= 0) then 
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Graphical Snake puts your reflexes to the test 


If you’re looking for a game that will make you 
addicted to using the Portfolio, Snake is for you. 

The object of Snake is to stay alive by eating the food 
that your keepers put in your cage. Every time you eat, 
though, shed some skin and become faster. You must eat 
your food without running into the walls of your cage, 
bits of your shed skin, or yourself. 


Snake is a 
i ———] 
graphical game, =. 
so it will consume 4 the \SNAKE 
battery power ON DISK subdirectory. 
more than _ nor- 


Snake can be found 
on Re:Port Disk #7 in 


mal use of the Portfolio. 

Be sure to keep a spare set of batteries with you 
always, especially if you plan to play Snake while 
travelling. 

The game begins with the snake anda bit of food. The 
“*food’’ is represented by a small dot. The three dots at 
the upper left of the screen represent the number of lives 
your snake has left. 

You control your snake by using the cursor keys. Be 
careful not to get your fingers confused; if you should 
accidentally hit the up key right after you hit the down 
key, you’ ll run into yourself and lose a snake. 

When you eat a piece of food, the Port will beep and 


The Snake playing field 


more food will appear. Y ou willalso ‘‘shed’’ some skin, 
which will appear as a box at a random spot on the 
screen. You have to avoid these boxes to survive. 

Also, after you eat some food, your speed will in- 
crease (the Port can actually run this game so fast that 
you can’t see the snake moving across the screen!) 

If you don’t find the game challenging enough at first, 
you can increase your speed manually by pressing the 
ENTER key. 

Press ESC if you wish to exit. 

At the end of the game, you will receive a score, 
which is 100 points for each piece of food that your snake 
ate. 

Warning: This game is simple, but it is highly addic- 
tive. Have fun! 

Re:Port has received a good response toward its 
games, so we'd like to include one in each issue. If you 
have an idea for a game you'd like to see, write to us and 
describe it in detail. 


Update of TODO.HOO corrects problem 


Several astute readers noticed a problem with the 
TODO.HOO program in issue #6. 

The program would read in more than one day’s 
worth of entries from the Diary. For instance, if you 
asked for all the Sept. | entries, the program would 
display everything from Sept. | though the last entry in 
your Diary. 

If you received a disk label ‘‘Re:Port Disk #6, Rev. 
1,’’ then you received a version written after the bug was 
discovered. 

For everyone else, there is a new version on the 
current disk. 

Thanks to the three readers who noticed the problem. 
They reported the bug to us on CompuServe and re- 
ceived new versions quickly. 


Bug Re:Port 


| 
| 
The updated version of TODO.HOO is in | 


ON DISK the \tToDo directory of Re:Port disk #7. 


All Re:Port programs are tested before publication, 
and some are even rejected for more work. Of course, 
some problems may get through. 

If you have a problem with a Re: Port program, please 
call 1-319-354-6893. We’ll try to figure out how to 
make the program work on your machine. If the 
program doesn’t work and does require an update, we 
will provide an update on the next Re:Port disk. If you 
need it sooner, we will send you a copy for $1.50, to 
cover the cost of a new disk and shipping. 
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DELETE.HOO solves scary situation 


If you haven’t had a need for this issue’s featured 
program, then consider yourself very lucky. Chances 
are that every Portfolio user that takes advantage of the 
built-in Editor will run into the following nightmare 
scenario sooner or later: 

Y ou’ re typing a report, and you decide to save the file. 
Unfortunately, it is too long to save on the C: drive. You 
decide to try to save it to your RAM card, but you find 
out that there isn’t enough space there, either. 

What’s left to do? If you’re lucky enough to have 
another RAM card with enough space handy, then that 
is the solution. If not, then all you can do is erase enough 
of the hard work that you’ve done to make the file fit on 
what little disk space you have left. 

This utility, DELETE.HOO, was suggested by a 
reader who ran into just sucha problem too often. It also 
adds a suggestion from another reader who wanted a 
way to find out how much free space was on his disks 
while he was using the Editor program. 

A .HOO (for Hook) file is a program that can be run 
from within the built-in Editor program. To use one, you 
must store it on the root directory of a RAM card in your 
A: drive. Then, hit Fn-6 while you are using the editor. 
A list of installed .HOO files will appear. Press enter on 
the one that you wish to use. 

NOTE: The .HOO files in Re:Port usually require 
quite a bit of memory and will not work if you internal 
C: disk size is larger than 24K. Re:Port recommends a 
C: setting of 16K for optimal use of the Portfolio. For 
more information on running .HOO files, see this issue’s 
Beginner’s Column. 

To use Delete, you must be in the built-in Editor. Press 
Fn-6 and choose DELETE.HOO. You will be shown 
how much free space is on the A: drive, along with a note 
about how many characters big the current Editor file is. 

Because of the way DOS stores files, you will want to 
have around 150 more bytes of free room on your disk 
than your file takes up. 

Press a key to clear this message and move on. If you 
do not wish to delete any files, hit ESC, and you will 
return to your Editor file. 

Delete now gives you a list of all the files on your A: 
drive. Any entry proceeded by a backslash (\) is a 


DELETE.HOO is on Re:Port Disk #7 under 
the \DELETE subdirectory; 


ON DISK 


C:UNNAMED .TRT = _L:4 Ctl Mi39 
Now is the time ie eit good men to 


come to try.4 

4 Disk free! “3768 

4 File size: 

Mon 18 Aus 92 18:64 oO INS 


Delete shows disk space and current file size 


C: oe «TAT L:4 Csi Ms:39 


iow is elete! men to 
come to t to Change drive try .4 
4 [ AUTBEREC .BAT | 
MORE .BAT 
Mon 16 Aus 92 16:65 INS 


Then, you get a list of files to delete. Choose 
‘** Change drive" to go to another disk, 
choose anything with a "\" character to go toa 
different directory, or choose a file to delete. 


subdirectory. To change to it, just put your cursor on it 
and press enter. Also, note that you can change disk 
drives by choosing ‘** Change drive.”’ 

Note that because of the fact that hook files like to run 
from the A: drive, you will start with a list of files on the 
A: drive, even if your current Editor file is stored on the 
C: drive. Just hit the * Change Drive function to move 
to C: ifyou wish. You will be given a new report of free 
disk space and the file size. 

The menu box of files that you see can contain up to 128 
filenames. Use the up and down arrows to scroll through 
the list, or press the first letter of the file that you want. 

Once you’ ve picked a file to delete, press enter. You 
will be given a chance to change you mind. Delete 
presents the filename and asks if you really want to 
delete it: Type Y or N for yes or no. 

If you type Y, then the file will be deleted. If you run 
DELETE.HOO again, you will see that you have more space. 

You can keep deleting files until you have enough 
space to store your current work. 


Re:Port 
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Utilities card good for new DOS users 


The DOS Utilities card (suggested 
price, $79.95; Re:Port price $71.96) 
is a collection of useful DOS pro- 
grams that all users should have. 

However, if you’ve been using 
DOS on a desktop computer for any 
period of time, you probably have 
most of these utilities lying around. 
And if you have access to an online 
service or computer club, you may 
be able to get many of these pro- 
grams. A couple of programs, such 
as MODE, differ from their DOS 
counterparts, but similar programs 
(such as Re:Port’s SETTINGS) are 
often available elsewhere. 

But if you are new to DOS and 
don’t have a desktop computer or 
any means of getting DOS programs, 
this handy ROM card can be your 
salvation. 

The disk contains 32 files, which 


DOS 
UTILITIES 


The DOS Utilities card by 
Atari is available to Re:Port 
subscribers for $71.96. It 
comes on a ROM card with a 
printed manual and some on- 
card documentation. 


include programs, drivers, graphics 
files, and some documentation files 
for programs that didn’t make it into 
the DOS Utilities Card’s excellent 
manual. 

The DOS Utilities Card also in- 
cludes the File Manager program, 
which, oddly enough, shields the 
user from DOS anyway. It’sastrange 
choice to put on a card that includes 
mostly programs that people who 


want to get their hands dirty in DOS 
would use. 

The other selections are fairly stan- 
dard but incredibly worthwhile if 
you don’t already have them. Some 
standouts are CMDEDIT.COM, 
which allows you to scroll through 
all the commands that you’ve typed 
on the DOS command line, and 
XCOPY.COM, a superb replace- 
ment for the COPY command that 
has many options, including copy- 
ing a directory and all its 
subdirectories. 

The list below details all the files 
on the DOS Utilities card and tells 
what they do. If you find that you 
don’t have at least three of these 
files, and don’t know where else to 
find them, then the DOS Utilities 
Card is something that you'll defi- 
nitely want to add to your collection. 


File Manager program 

Displays amount of free space and 
returns a value you can use in a 
batch file. 

Displays amount of free space in the 
largest block of memory. 

Provides a means to enter key- 
strokes automatically during a batch 
file. 

Compiles text which describes key- 
strokes for KSIM. 

Select setup options automatically, 
like Re:Port’s SETTINGS program. 
Limits access to your Portfolio. 
Reboots your Portfolio (like hitting 
Ctrl-Alt-Del, or pressing the but- 
tons on the bottom of the Portfo- 
lio). 

Sorts a text file. 

Adds a print spooler to your Port, 


DOS UTILITIES LIST 

AUTOEXEC.BAT: Batch file that turns on FM.COM: 

UPDATE.COMand shows the three FREEDSK.COM: 

graphics files included on the DOS 

Utilities card. 
ASK.COM: Asks the user for a keypress. The FREEMEM.COM: 

answer can then be used in a batch 

file. KSIM.COM: 
ATTRIB.COM: Sets (or displays) the attributes of a 

file. For instance, you may set a file 

to Read-Only mode with this com- KSIMCOMP.COM: 

mand so it cannot be overwritten 

or deleted. MODE.COM: 
BEEP.COM: Makes the Portfolio generate a tone 

for a period of time. PASSWORD.COM: 
CMDEDIT.COM: Creates a “command history” so REBOOT.COM: 

you can avoid retyping DOS com- 

mands over and over. 
DIF.COM: Compares the text in two files. 
DSKCHK.COM: Checks disk for corruption (similar SORT.COM: 

to CHKDSK in DOS). SPOOL.COM: 
FIND.COM: Searches files for specified text. Continued on Page 8 
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shipping the cards by the end of September 1992. 

Flash memory cards will work in both the Portfolio 
and the PC Card Drive, for extended compatibility 
between your Port and your desktop. 

The cards are designed to fit in the Portfolio’s card 
drive slot, so they are just as compact as regular RAM 
cards. And they have another advantage besides their 
increased memory capacity -- they require no batteries! 
Optrol’s Mark Reeves says that even under extremely 
heavy use of the Flashcards (meaning writing to the card; 
it can be read indefinitely), your data will be retained for 
10 years. 

Flash cards are also slightly faster than RAM cards. 

Flash memory card technology does have its draw- 
backs. You must load driver software onto your Portfo- 
lio in order to make the card work with the Portfolio’s 
DOS (the driver is supplied on the card). Also, because 
of the way that Flash memory chips store data, you must 
occasionally ‘‘clean’’ the memory card. When you 
delete files, they still take up storage space on the card, 
so eventually the card will be filled, although not neces- 
sarily with active files. Software on the card will allow 
you to free up the extra storage space; Reeves says that 
this procedure will take about 10 seconds. ’ 

Considering that the price of the 1 meg card will be 
about the same or lower than a 128K card, those disad- 
vantages seem extremely small. 


F las h Cc ard Ss Continued from Page | 


At the time of this writing, Optrol was not able to 
supply a finished product for review, so we’re not able 
to report on how well it works in real-world conditions. 
We'll try to have one next time, depending on what kind 
of response we receive about this product (and response 
should be heavy!) 

Flash memory cards are based on Intel’s new Flash 
chips, which were developed as an alternative to hard 
disks in sub-desktop computers. However, the cost-per- 
megabyte is much higher for Flash chips than for hard 
drives. So for now, you will see Flash technology 
mostly used as RAM cards. 

Although the upper limit of Flash chips is now 4 
megabytes (which Optrol takes advantage of, thank- 
fully), Intel predicts that they can take them up to 64 
megabytes in the future, so look for more expansion to 
come. 

Because of the differences in the Portfolio and its card 
drive, standard Flash cards used in other computers will 
not work on our machines. 

For now, Optrol is the only company that provides the 
hardware and software to allow Port users to take 
advantage of this greater storage. 

To contact Optrol for orders or more information, 
telephone 1-919-779-3377 or call their support BBS 
(called Any Port in a Storm) at 1-919-598-5320. Write 
them at PO Box 37157, Raleigh, NC 27627. 


DOS Utilities 


i | 
] ist Continued from Page 7 
| 


so you can print in the background 
while you continue to work. 


TOD.COM: Prints time of day and returns a 
country value for use in batch files. 

UPDATE.COM: Very important file: Fixes internal 
software bugs. 

XCOPY.COM: Incredible upgrade to the COPY 
command. Many features. 

XDIR.COM: Enhanced directory display. 

XTERM.COM: Communications program with 
XMODEM. 

PGSHOW.EXE: Program to display Port graphics. 

DOS_UTIL.PGC: Graphic of the DOS Utilities label. 


FUJILPGC: Graphic of the Atari Fuji symbol. 
PORTF.PGC: Graphic of the Portfolio logo. 
ANSILSYS: Screen driver for the Portfolio. 
Helps make the Portfolio more com- 
patible with some DOS programs 
that do ANSI screen writing. 
DEVINFO. TXT: Information on how to become a 
Portfolio developer. 
PBDEVKIT.TXT: Information on how to order the 
PowerBASIC development kit. 
UPDATE.TXT: Information on using 
UPDATE.COM. 
XTERM.TXT: Information on using XTERM.COM. 


Re:Port 
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Beginner’s Column 


How to run Editor Hook files if you haven’t before 


If you are new to Re:Port, or if you have not yet tried 
one of our many Editor Hook programs, there are a few 
things to learn before you do try. 

An Editor Hook program is usually referred to as a 
.HOO file, because that is how the program looks when 
it is stored on disk, and that is how you will see it ina 
program menu. For example, the Editor Hook included 
in this issue of Re:Port is called DELETE.HOO. 

Editor Hooks are programs that can be run at the same 
time that you are running the built-in Editor program. 
Any .EXE or .COM program can be turned into a .HOO 
file, simply by renaming it. 

However, the real power of .HOO files is that spe- 
cially written ones are able to interact with the built-in 
Editor itself to add functions to the Editor. 

For instance, Re:Port has publisheda spelling checker 
and a macro program in addition to the Delete and Todo 
programs included in this newsletter. 

To run a .HOO file, you put them in the root (main) 
directory of the A: drive, bring up the built-in Editor, and 
press the Fn-6 key combination. 

A menu of the available .HOO files should appear. 
Select the program you want to run by moving the cursor 
to that filename and press enter. 

When a user sees a .HOO file running for the first 
time, after the initial joy wears off, the first question is, 
‘*Can the other applications do this? I'd like to make a 
program that does ‘x’ in my Worksheet, or Diary, or 
Address Book.’’ Sadly, the answer is ‘‘No.”’ 

Only the built-in Editor allows such an easy method 
that is fully supported by Atari and therefore easier for 
programmers to access. 

If you can’t get a .HOO program to run, take the 
following steps: 

1. Make sure all the files that were included with 
the program are copied onto the A: drive in the main 
directory. 

Some .HOO files have other data files that they 
expect to find if they are to run correctly. 

Copy every file that the documentation requires into 
the root (main) directory of the A: card. 

If you issue the commands A:, CD \, and DIR, you 


should see your files. 

2. Check your CONFIG.SYS file for the BUFF- 
ERS= line. 

If the program still doesn’t run, it should be giving 
you an error that reads ‘‘Failed to run program.”’ 

If that is the case, first try editing the filleCONFIG.SYS 
on your C: drive. 

If this file contains a line that says BUFFERS=and a 
number, delete this line and reboot the Portfolio. 

Try running the .HOO file again. 

3. Free more memory for the .HOO program by 
lowering the size of your C: drive. 

If the program still won’t run, back up all the files on 
your C: drive. 

Then issue the FDISK command to reduce the size of 
your C: drive, which will in turn expand the memory that 
is available to the .HOO files. 

Suggested C: drive size for people who run .HOO 
files often is 16K. 

So, if you issue the command FDISK 16, you should 
be all set to run .HOO files. 

4. Do not run the File Manager program. 

Often, when the Portfolio reports that it is out of 
memory while you are running an internal application, 
youcan get more memory by not using the File Manager 
program. To disable to File Manager program, hit ESC 
and type D. That will take you to the DOS level. If you 
are not comfortable with DOS, press Atari-Z, and you 
will receive a simple menu of the internal applications 
that does not take up any additional memory. 

One of the best things about the Portfolio is its ability 
torunDOS. That is what makes it a computer rather than 
a handheld organizer. To learn more about DOS, there 
are many books you can check out. Although the title is 
a bit offensive, the book ‘‘DOS for Dummies’’ is 
recommended reading. Basically, look for anything that 
talks about DOS 3.0 or lower, not any of the newer books 
that deal with DOS 5.0 or 6.0, the advanced desktop 
versions of DOS. 

Ifthese steps don’t work for you, contact Re:Port, and 
we will help you get the programs up and running right 
away. 


Follow these tips for programs that have a hook 


From the first issue, Re:Port has 
been publishing Editor Hook pro- 
grams, or .HOO files. 

The built-in Editor provides the 
ability to shell out to any .EXE or 
.COM file that is renamed with the 
extension .HOO. 

But writing .HOO files is not that 
simple. In order be to truly useful, a 
-HOO program must take advantage 
of the special functions that DIP 
provided to control the functions of 
the built-in Editor. 

In your .HOO program, you will 
have the ability to use the following 
functions to access the text within 
the editor. 

They are all accessed using inter- 
rupt $60, function $03: 

EDHO_GOTO: Movesthecur- 
sor (minor function $00) 

EDHO_GET: Getthecursor’s 
position (minor function $01) 

EDHO_REF: Refreshes the 
editor screen (minor function $02) 

EDHO_LOC: Returns the 
memory locations of the current char- 
acter. This function basically allows 
you to read the text in the editor file 
(minor function $03) 

EDHO_INS: Allows you to 
insert a string into the editor file, as 
if it were typed in by the user (minor 
function $04) 

EDHO_DEL: Delete charac- 
ters from the edit text (minor func- 
tion $05). 

See the Atari Portfolio Technical 
Reference Guide for specifics on 
each function. 

Once you have identified your 
application as something that would 
be well-suited as a .HOO file (ex- 


Source code to 
Re:Port programs 
can be found on 
Re:Port disk #7 in 
the \SOURCE 
directory 


ON DISK 


amples from Re:Port are Macro, 
SplChk, Todo, Delete, and others), 
then you have many options as to 
how to present the .HOO file to the 
user. 

The file can clear the screen and 
act as a full screen application, or it 
place its menus ‘‘on top’’ of the 
editor screen for a built-in function 
effect (this issue’s Delete does the 
latter). 

Or, if you program simply inserts 
text in the editor or writes to a file in 
the background, you may have no 
screen interaction at all. 

If your program falls into one of 
the first two categories, remember to 
call the Portfolio’s Screen Save and 
Restore function before the program 
begins. 

Although the operating system 
provides an EDHO_REF function, 
it is not always able to restore the 
screen correctly after a .HOO file as 
run. 

Note that the editor file does not 
have to be on screen while the .HOO 
file is running in order to use the 
EDHO functions. They are all done 
in memory. 

Speaking of memory, it is prob- 
ably the most important .HOO file 
consideration. 

Y ou will want to write a program 
that uses as little memory as pos- 
sible, because when the Editor is 


running, it uses up 64K of free 
memory. 

Your .HOO file must squeeze into 
the remaining space (if any). 

To maximize space, always set 
your program’s internal stack to the 
lowest value possible. 

Also, reduce the maximum heap 
size that your program is allowed. 

Pascal programmers may use the 
compiler directive {$M 
stack,minheap,maxheap}. 

Typically, we set this to the low- 
est value {$M 1024,0,0} and go up 
from there as needed. 

When you release a .HOO file to 
the general public, always recom- 
mend that they reduce their C: drive 
size to 16K. 

If users complain that they are 
receiving a message that reads 
‘*failed to run program,’’ refer them 
to the list of solutions on Page 9. 

Usually, setting the FDISK value 
to 16 will solve most memory prob- 
lems, but the BUFFERS= line in 
CONFIG.SYS causes problems, too, 
as does the File Manager program 
(Atari’s own Instant Speller hook 
won't run under FM). 

Also, remember that the .HOO 
file is run from the A:\ directory. 

Your program will default to this 
directory, so compensate for that if 
you wish to read or write files in 
other areas. 

Please let us know if we can be of 
any help while writing .HOO files. 
If you come up with any that you’d 
like to share, send them in! 


The Atari Portfolio Technical 
Reference Guide is $60 from Atari 
or Re:Port newsletter. 
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Online Services 


Lively online talk ss Catalogues of the new files avail- 


+>. able on CompuServe and GEnie 
Recently, both GEnie and CompuServe have had lots = are available on your Re:Port Disk 
of traffic in the message areas. ON DISK = #6 in the \ONLINE directory. 
On GEnie, the talk focused on the differences between CompuServe wants all Re:Port readers who aren’t 
the Portfolio and the HP9SLX, in response toamember’s || ™embers to sign up now, so they've put forward a 
question. special offer to our subscribers. 
On CompuServe, the conversation spans many impor- FOu.Gan gene syne HE and $15 worth of free 
tant topics. Look for a new debugger from BJ Gleason Sakai tliat = Snag. Giag ke ertane” scarred 
: ere 2 88 3 Operator 198). Tell them that you heard about this 
online soon, as well as more information about the new front Re-Pivt, an APORTFOLIO forum member. 
multi-megabyte Portfolio Flash Memory Cards. 


Re:Classifieds 


For sale: cessories and Peripherals Bulletin bs SE 

° 4 ° : o reach other Fortiolio users, place 
New Portfolio. Includes: booklets, Portfolio product literature, an Re:Classified ad! 
Parallel link and cable and Re:Port price lists and fliers. 25 words or less : $3.50 
Two RAM cards, 128K and32K You can even get specially coded re . pa hee 
AC Adapter fliers to give to business contacts to (coche chan cial coreeaiileis, ce 
File Manager guarantee that you'll geta $5 finder’s add $1 to have Re:Port newsletter act as a 
Just $300 or best offer. Call I- fee. Write to Re:Port Marketing at | S72eweeh nck 

818-700-8420. 806-34 Benton Drive, Iowa City, IA Re:Port newsletter 

Free! 52246-5207 to get more informa- 806-34 Benton Drive 


lowa City, IA 52246-5207 


Re:Port has loads of Atari’s Ac- _ tion. 


‘Contest 
Get $5 off any Re:Port product with Contest #7 


Congratutations to Richard Alexander; who géetsaSs 0 eee a, 
gift certificate for last issue’s contest. Let’s give away Re: Port Contest #7 
another one! This is good toward any purchase through 
Re:Port, such as product orders, resubscriptions, or 
Re:Classifieds. 

To enter, make a copy of the form at the right, fill it 
in, and send it to Re:Port, 806-34 Benton Drive, lowa 
City, [A 52246-5207. Or, enter by phone. Call 1-319- Editor Worksheet Address Book 
354-6893 and leave a message with all the information Diary Calculator 
on the form. Deadline is October 15. Lee Sy le ee ee See eee A By 


Name: 
Favorite use of the Portfolio: 


Favorite application (pick two): 
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Dear Re:Port, 

I have a question. 
UPDATE.COM, do I 
UPDATE.ARC? 

Does anyone have a handicapping 
program for horse races? 

— Thomas Bengraff, 
New Jersey 

[Editor’s reply: We’ve hada lotof 
questions about UPDATE.COM re- 
cently, so we’ve included a copy of it 
again on this disk. To use 
UPDATE.COM (which is called 
UPDT107.COM on our disk), just put 
it in your \SYSTEM subdirectory of 
your C: drive and add the line UP- 
DATE (or UPDT107) to your 
AUTOEXEC.BAT file. Reboot your 
Port. It should say ‘‘Update+ OK.”’ 

The Update program fixes some 
bugs in the Portfolio’s internal pro- 
grams. You should always have a 
copy running. At Re:Port, we have 
notexperienceda system-related crash 
while running Update. 

As for the difference between 
UPDATE.COMand UPDATE.ARC, 
no, you do not need UPDATE.ARC. 
On many online services, you will see 
files that end with the extension .ARC 
or .ZIP. These are called ‘‘archives”’ 
and you usually need special programs 
to process them. However, once you 
have what you need out of the archive, 
you no longer need the archive file 
itself. Go ahead and delete 
UPDATE.ARC. 

There are horse handicapping pro- 
grams that have been written for 
palmtop machines, but we no of none 
specifically for the Portfolio. If any- 
one does, please write in. If you have 
access to CompuServe, check out the 
sports forum there. They have some 
horse racing-related programs, many 


I have 
need 


of which were written in BASIC and 
can easily be converted for Port use 
with PBASIC or PowerBASIC.] 


Dear Re:Port, 

When I subscribed to Re:Port, I 
also ordered HyperList. The program 
seems to work fine on my Portfolio. 
Except, once in a while when I try to 
print I get an error message that says I 
tried to access the B: drive. My 
AUTOEXEC.BAT file is on a 64K 
memory card. When I get this mes- 
sage, Idoa warm bootwithmy memory 
card in the A: drive, and this solves my 
problem for the time being. 

The most perplexing problem is 
using HyperList on my IBM PS/2 in 
my office or my IBM PS/2 at home. | 
copied the HyperList files to a 
subdirectory called HL ona 3.5" disk. 
[ have a batch job called HL.BAT that 
changes to the HL subdirectory and 
starts HyperList with the HL com- 
mand. The R.BAT command doesn’t 
work on the PC but does work on my 
Portfolio [Editor’s note: Right. The 
R.BAT file contains the command 
RUNHL.RUN, whichis notavailable 
on the desktop PC.] 

The programs runs, and | can create 
.HL files. However, when | try toprint 
the file a message appears: *‘No such 
file or directory.’’ And only the first 5 
or 6 lines of the first page print out. | 
have attached copies of the printout 
and a screen print of the message. [ 
have tried several different approaches 
with no success. My HL.BAT file 
uses the -da switch to tell HyperList 
that the PERMDATA.DAT file isina 
subdirectory on the 3.5" disk inmy A: 
drive. | have also tired creating the 
\SYSTEM sudirectory on the C: drive 
of my PC’s. 


Re:Port 


I would sure like to print my files 
from my PC. Also, one of my files is 
large enough and growing that it may 
only work on my PS/2. 

-- Merlin Siefken, 
lowa 

[Editor’s reply: Thank you for 
including so much detail in your de- 
scription of your problem. Unfortu- 
nately,-I’m still not sure if we can 
diagnose this problem correctly. 

Trying to run HyperList from a 
desktop PC, I also ran into the same 
problem printing that you did, but [ 
was able to clear it up. I think, though, 
that I did the same things that you 
suggest but didn’t have any luck with. 

Icreateda\SYSTEM subdirectory 
on the same drive as HyperList. How- 
ever, I did not use the -d switch when 
loading HyperList. Simply typing in 
HL was enough; the program auto- 
matically looks in the \SYSTEM file 
for a copy of PERMDATA.DAT. | 
setup PERMDATA.DAT onmy Port- 
folio by first going into the Atari-S 
setup menu, and picking Printer. | set 
up the printer on my Portfolio using the 
specifications for my desktop printer. 
Then | escaped from that menu and 
copiedthe resulting PERMDATA file 
into the \SYSTEM directory on my 
desktop computer. 

HyperL ist was able to print just fine 
after that, and it only reported the error 
once, when I tried to print too quickly 
after [ requested another printout. Per- 
haps you could study the MODE com- 
mand in your PC-DOS documenta- 
tion that came with the PS/2 to learn 
more about the way your computer 
talks to your printer. My first inclina- 
tion would be to set the RETRY value 
to something higher than NONE. Try 
it and let me know how it works. | 


